[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
VGETCHRS Introduced: v3.12
. Summary
vgetchrs(int <x>, int <y>, str <buf>, int <pos>, int <num>);
. Description
The vgetchrs function is used to read multiple characters starting
from a spot on the screen into a specified variable. Vgetchrs saves
only the characters (a sequence of bytes). <x>,<y> is the spot on
the screen to start reading characters. <buf> is the string variable
to put characters into, starting at an offset of <pos> in the variable.
Note that this function does not put a 0 (NULL, or end of string charac-
ter) at the end of the sequence of characters it grabs. If the
characters returned by vgetchrs are to be manipulated as a string a
0 must be added at the end with the setchr function.
. Return Value
None.
. Example
// copy 20 characters starting from 10,10 on the screen to 20,20
// Don't keep color attributes
str buffer[20];
vgetchrs(10, 10, buffer, 0, 20);
vputchrs(20, 20, buffer, 0, 20);
See Also:
vgetchr
color chart
ASCII table
vgetchrsa
vputchrs
vputchrsa
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson